home *** CD-ROM | disk | FTP | other *** search
/ Aminet 8 / Aminet 8 (1995)(GTI - Schatztruhe)[!][Oct 1995].iso / Aminet / comm / tcp / interInstal.lha / INTERINSTALL / II_README < prev    next >
Text File  |  1995-08-01  |  12KB  |  271 lines
  1.  
  2.                    INTERINSTALL v1.50  30-Jul-95
  3.  
  4.               by Christopher Laprise (chrisl@ici.net)
  5.  
  6.  
  7.  
  8.  
  9.  
  10. Stuff:
  11. ------
  12.  
  13.  INTERINSTALL comes with no warranties expressed to implied; Use at
  14. your own risk.
  15.  
  16.  INTERINSTALL is 'giveware'.  You are encouraged to send a donation
  17. of Five US dollars (or more :-)  as 1) US money order; 2) check drawn on
  18. a US bank; 3) international money order in US funds -to this address:
  19.  
  20.            Christopher Laprise
  21.            189 Franklin St.
  22.            Fall River, MA  02720
  23.            USA
  24.  
  25.  
  26.  
  27. Intro:
  28. ------
  29.  
  30.  INTERINSTALL was written to address the significant problem that Amiga
  31. users face in configuring AmiTCP for internet access. Thus far, we've
  32. had a distinct disadvantage since many of the TCP/IP packages for other
  33. platforms are already geared to connect with certain Internet
  34. providers, or at least for dyanamic PPP/SLIP access where a large
  35. service assigns seemingly-random host addresses for each call. Perhaps
  36. someday the authors of Amiga Internet software will offer special
  37. install scripts for major providers.
  38.  
  39.  The INTERINSTALL script tries to cut out many unnecessary steps and
  40. questions for the installation of AmiTCP and PPP, the basic protocol
  41. software needed to access the Internet.
  42.  
  43.  ( v1.00 & 1.02 users-  Read these docs!  Significant changes! )
  44.  
  45.  
  46.  
  47. Requirements:
  48. -------------
  49.  
  50.  An INTERINSTALL module file for your Internet Provider
  51.    (Compuserve, EmpireNet and LogOnAmerica supplied)
  52.  AmiTCP 3.0b2 (exactly this version)
  53.    (available at http://insti.physics.sunysb.edu/AMosaic/ftpdir/support/
  54.     and some of the ftp sites associated with AmiNet)
  55.  PPP 1.30 by Holger Kruse (evaluation version)
  56.  Serline 1.52 by Chris Laprise (supplied)
  57.  Amiga OS 2.04 or greater
  58.  
  59.  
  60.  
  61. Procedure:
  62. ----------
  63.  
  64.  You must first de-archive the AmiTCP & PPP packages into the INTERINSTALL
  65. directory. The resulting AmiTCP and PPP sub-directories _must_ be named
  66. "AmiTCP-3.0b2" and "PPP" respectively.  Also put the proper module file
  67. for your Internet Provider in the INTERINSTALL directory.
  68.  
  69.  Next, run INTERINSTALL by clicking the icon, or from Shell by CD'ing
  70. to the INTERINSTALL directory and typing "execute INTERINSTALL".
  71.  
  72.  You will see some info, including the CPU you're using, and will be
  73. asked questions concerning data that the ppp.device needs to function.
  74. Be careful entering the device name, since device names are
  75. case-sensitive.
  76.  
  77.  If all goes well, you should be asked for a modem initialization string.
  78. A simple "ATZ" may do for you, but many modems differ in their defaults
  79. and commands. If you are in doubt and you have a high-speed modem (9600
  80. BPS or greater) then you need to supply a modem init. which does the
  81. following:
  82.            Enable RTS/CTS hardware flow control (suitable cable required)
  83.            Disable software flow control (XON/XOFF)
  84.            Enable ASB (data buffering)
  85.            Enable error correction (V.42 or MNP4)
  86.            Enable English-word result codes
  87.            Cause CD line to track actual carrier-detect state
  88.            Disable DTR hang-up mode  (Lets you resume connection after
  89.                                      a crash. Otherwise, you can leave
  90.                                      it enabled.. see notes below.)
  91.  
  92. On my modem, a Practical Peripherals PM14400FXSA, it would look like:
  93.            AT&K1&Q5Q0V1&C1&D0
  94.  
  95.  If the procedure goes smoothly, you should see the `INSTALL COMPLETE'
  96. message telling you to reboot the computer.
  97.  
  98.  
  99.  
  100. Usage:
  101. ------
  102.  
  103.  After rebooting, typing "internet" in a Shell should start the connection
  104. (the PPP script window will appear, logon, then disappear). A small window
  105. saying "StartInternet complete" will let you know when you can run your
  106. internet programs (ncftp, telnet, AMosaic, etc.). The "internet" command
  107. is just a Shell script in the S: directory that runs the
  108. amitcp:bin/startinternet script with all I/O redirected to NIL:.  It's a
  109. convenient way to start things and not have a Shell window stuck to the
  110. Workbench screen. An icon has also been included in case you like to start
  111. it from Workbench... just drag it to your favorite telecomm drawer. 
  112.  
  113.  For a quick test after connecting, try running ncftp in a Shell and then
  114. typing "OPEN ftp.compuserve.com" or other addresses like "ftp.portal.com",
  115. "ftp.wustl.edu".  Of course, Ping is always a good test.  Once you feel
  116. that AmiTCP and PPP have been installed to satisfaction, you may delete
  117. the INTERINSTALL directory.
  118.  
  119.  To disconnect, quit your internet programs and run stopnet. Stopnet will
  120. ask "Also attempt modem hangup?"  Answering `n'o or just hitting return
  121. will tell AmiTCP and PPP to shut down, at which point your provider should
  122. hang up for you. But if you want to make sure the modem hangs up you can
  123. answer `y'es and stopnet will send a hangup command to the modem in
  124. addition to the AmiTCP/PPP shutdown. The modem hangup option makes good
  125. sense if your modem is set to ignore DTR (which lets you Resume connection
  126. after a crash/reboot, but also means the modem won't necessarily hang up
  127. on its own when PPP shuts down).
  128.  
  129.  That's about it.... Good luck!
  130.  
  131. -Chris
  132.  
  133.  
  134.  
  135. NOTES:
  136. ------
  137.  
  138.  * The current PPP version (1.30) apparently has a buggy dialer. It may
  139.    not behave properly with certain modem init. strings or telephone #s.
  140.    For instance, when I changed the tel# to the CIS 1-800 line, the dialer
  141.    would zip through almost the entire script seemingly ignoring the WAIT
  142.    commands... it didn't even dial. Other numbers work OK for me.
  143.    Another instance is when I changed the init. from ATZ to a longer, more
  144.    explicit one (for testing) causing similar bad behavior.
  145.  
  146.  * Some programs require socket.library to work (this emulates Commodore's
  147.    unreleased TCP software).  The startinternet script checks for this
  148.    library in AMITCP:libs (not libs: !) and loads it if present.
  149.  
  150.  * Normally, you'll have to type the full AMITCP:bin/... path to use
  151.    commands like ncftp, because you'll be missing a path-assignment
  152.    (except when using 'internet' from Shell, the path will be set in
  153.    that one Shell). You may want to put a "path amitcp:bin add" command
  154.    in your s:shell-startup.
  155.  
  156.  * It is possible to *resume* a connection after a system reset (caused
  157.    by a crash perhaps) so long as your modem is set to ignore DTR (i.e.
  158.    it doesn't hangup when DTR turns off during a reset). Upon rebooting
  159.    with your modem still connected, running the Internet startup should
  160.    cause the connection to resume as if nothing happened.
  161.    This is a nice feature that can save you lots of time when dealing
  162.    with bug-ridden internet programs that keep crashing the system.
  163.    
  164.    Most modems can be set to ignore DTR with the &D0 command. If your
  165.    init. string has a &D1 or &D2 command you can replace it with &D0.
  166.    If your init. string is normally simple like ATZ (reset to defaults)
  167.    and this default doesn't ignore DTR, you can try using ATZ&D0 instead.
  168.  
  169.    You can terminate the connection with Stopnet, and your ISP _should_
  170.    hangup (stopnet also asks you if you also want to tell the modem to
  171.    hang up).  However, if you seemed to connect in the first place but
  172.    did _not_ get the Startnet Complete notice, then you should not try
  173.    simply rebooting and resuming; something is wrong with the connection
  174.    itself and the ISP's nameservers may be down.  Instead, run Stopnet
  175.    (breaking the connection completely) then retry for a fresh connection.
  176.  
  177.  * Some people have reported problems with the installation stopping
  178.    dead after the 'proceed?' prompt. Other people have had bizarre
  179.    errors regarding ENV: variables (including the ppp0.config). All I
  180.    can say to this is that it works with  A) A4000 WB3.0 with _lots_ of
  181.    enhancements;  B) A3000 WB2.04 very enhanced & using GVP IOExtender;
  182.    C & D) both systems booting plain "original" WB disks. If you have
  183.    problems similar to the above, there is likely something wrong with
  184.    your system (bad startup-sequence or some add-on utility conflicting
  185.    with the normal operation of ARexx and Shell scripts). Before sending
  186.    messages stating that you have found a so-called bug in INTERINSTALL,
  187.    please check whether it works booting from a copy of a _plain_ WB2.04
  188.    (or above) disk. (You can keep INTERINSTALL/AMITCP/PPP on the hard disk
  189.    and run it from there even though you booted from a WB floppy.)
  190.    
  191.    Also, if you are having problems startng the connection, try starting
  192.    it in a Shell with "execute amitcp:bin/startinternet" instead of
  193.    using "internet".  This will allow you to see any error messages being
  194.    generated.
  195.  
  196.  * Why did I use AmiTCP 3.0b instead of 4.0? Personally, I don't see
  197.    any advantage to the demo version 4.0, and it can be a nuisance...
  198.    ( . . . especially with *no* documentation!!! )
  199.    Plus, once connected, 3.0b works as well and perhaps bit quicker
  200.    than 4.0 demo. I may consider upgrading the script to handle both
  201.    in the future.
  202.  
  203.  * IIMOD files can be 'built' for different Internet Providers. However,
  204.    it is currently limited to dynamic PPP links (no pre-assigned host
  205.    numbers). The current IIMOD format simply describes the
  206.    "envarc:sana2/ppp.dial" script and the "AmiTCP:db/netdb-myhost" file
  207.    containing domain names and nameservers. The #MODULE and #END lines
  208.    are necessary at the start and end of the dialer part (the rest is
  209.    netdb-myhost). The ;INSTALL lines allow the installer to ask the user
  210.    for info to be inserted into the working dial script.  The IIMOD
  211.    filenames cannot contain spaces.
  212.    
  213.  * If you need a module for your Provider, mail me with the following:
  214.  
  215.         - The real name of the provider
  216.         - Their domain name
  217.         - The IP addresses of their nameservers (2 or more are nice)
  218.         - Any logon prompts for name, password, service, host, etc.
  219.           that lead to the PPP protocol startup.
  220.           (supply the exact sequence, spelling and case!)
  221.         - US$10 fee to cover my time and costs
  222.  
  223.    Also send your email address if you'd like the module quickly sent to
  224.    you (otherwise a floppy will be sent).  The module that you get will
  225.    be designated as a beta version until I receive word from you that it
  226.    works.   (see above for my address)
  227.  
  228.  
  229.  
  230. HISTORY:
  231. --------
  232.  
  233.    1.50 Transformed into a modular format in which the Provider
  234.         specifics are determined by .IIMOD files. These describe the
  235.         dialer and "netdb-myhost" files. CIS and EmpireNet are included.
  236.         The CIS dialer now overrides the initial menu.
  237.         
  238.    1.11 Added additional nameserver addresses to AmiTCP config.
  239.         Stopnet checks if AmiTCP is running first (helps ensure that
  240.         PPP will be told to go offline). Installer now handles paths
  241.         containing spaces. Stopnet can attempt to tell the modem to
  242.         hang up. 'Startinternet' makes sure that the serial port is not
  243.         already in use. (The last two features required that I switch PPP
  244.         back to using shared mode.)
  245.         Version for EmpireNet released; Thanks to Thomas Barker for the
  246.         net info and testing.
  247.  
  248.    1.03 Reduced PPP SERBUF size to 4096 since the default was stressful
  249.         to some systems. Increased dialer DELAYs slightly. Added initial
  250.         DELAYs before modem init. 'Startinternet' checks to see if AmiTCP
  251.         is already running. Dialer uses '+' prefixes to help normalize
  252.         the CIS logon text (Compuserve version).
  253.  
  254.    1.02    Added a work-around for the PPP dialer bug, which seems to work,
  255.     by putting small DELAYs before each WAIT.
  256.     Added icon to stopnet. 'StartInternet' script now insures that
  257.     AmiTCP is not started up if PPP has failed to connect.
  258.  
  259.    1.01    Changed ppp.ds.cis script to use "+CIS" for Hostname, wait for
  260.     "CT" instead of "00" on modem connect, and delay 1 sec after
  261.     connect. These should work under wider range of circumstances.
  262.     Changed INSTALLCIS.rexx to ensure script bits for 'internet'
  263.     & 'stopnet'. From icon, the window is now AUTO and disappears
  264.     if the script terminates. Also configs PPP to NOT use shared
  265.     serial mode so any device conflicts are immediately suspected.
  266.     Changed 'startinternet' to mount TCP: as well as INET: for
  267.     programs like telnet.
  268.  
  269.    1.00    First release.
  270.  
  271.